home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Precision Software Appli…tions Silver Collection 1
/
Precision Software Applications Silver Collection Volume One (PSM) (1993).iso
/
windows
/
games
/
tif2win.exe
/
BIT2WP.DOC
next >
Wrap
Text File
|
1989-12-03
|
8KB
|
269 lines
BIT2WP V1.0 BIT/RLE Image File
to
Word Processor Image File Translator
Copyright 1989 by William J. Hinkle
=== User's Guide ===
The BIT2WP program was created to allow image files from Lotus Manuscript,
or from other conversion utilities, to be used by other word processing
programs that handle graphics, and in other graphics programs. To do this,
BIT2WP translates these BIT/RLE files into any of several other graphics file
formats. You can translate to:
* .WPG files (Word Perfect 5 graphics format)
* .TIF files (Aldus/Microsoft TIFF format)
* .BIT or .RLE files (Lotus Manuscript graphics format)
* .IMG files (GEM Paint format)
* .GIF files (CompuServe Graphics Interchange Format)
* .PCX files (PC Paintbrush PCX Format)
The translator is a single file: BIT2WP.EXE. The default translation is to
Word Perfect (.WPG) format.
==============
COPYRIGHT INFO
==============
This utility program BIT2WP.EXE was written by
William J. Hinkle
who retains the copyright. Copy and use the program freely. Distribute
it to whomever you want. But:
=== Do NOT distribute modified versions.
=== Do NOT remove the copyright notice.
=== ALWAYS distribute with the documentation.
=== DO NOT charge a fee, except for disk copying/library charges.
If you feel that this program has been of some utility, please remit
a contribution of $10.00 to help defray my costs run up in developing
this utility. You will receive a written receipt.
William J. Hinkle
420 E.Boston Mills Rd.
Hudson, OH 44236-1111
===============
BASIC OPERATION
===============
To create a .WPG file (the default), type in:
BIT2WP fname1
or
BIT2WP fname1.BIT
or
BIT2WP fname1.BIT fname2.WPG
from the DOS command prompt.
* For "fname1", substitute the name of your BIT file, of course!
You must spell out the .RLE extension if an RLE file is to be converted.
Note that Lotus Manuscript .SCG files are the same as .BIT files.
* The .BIT and .WPG extensions are assumed if something else is not specified.
* The .WPG file name is made the same as the .BIT file name if not otherwise
specified. Specify a different "fname2" if desired.
* Full DOS pathnames can be specified. If you enter a directory (ending in \)
or a drive (ending in :) for the second ("fname2") filename, the output file
will be placed on that path with the default filename; i.e, the input filename
with a .WPG extension.
The .BIT file will be translated to a .WPG file.
The .BIT file will not be erased. You can also specify scaling factors, but
the defaults work the best (see below).
==================
OTHER FILE FORMATS
==================
To create a new graphics file in one of the other supported formats, you must
specify the other format. You have two ways to do this. One way is to
specify the output filename ("fname2") with the appropriate extension. The
other is to specify the special /f option switch that selects the desired
format. The second method is usually the best, because the .BIT file's
filename is then automatically used for the output file.
Some examples:
---
* To get a Aldus/Microsoft TIFF file:
BIT2WP fname1 /ft
or
BIT2WP fname1.BIT fname2.TIF
gives you a TIFF file.
---
* To get an uncompressed (BIT) Lotus Manuscript graphics file:
BIT2WP fname1 /fr
or
BIT2WP fname1.BIT fname2.RLE
---
* To get a compressed (RLE) Lotus Manuscript graphics file:
BIT2WP fname1 /fr
or
BIT2WP fname1.BIT fname2.RLE
NOTE: Be careful how you specify your filenames for cross-converting BIT/RLE
files. You must not overwrite the input file, so be sure to specify the
correct output filename or format. BIT2WP makes sure you haven't specified
the same filename for input and output files, but it can be tricked, so be
careful!
---
* To get a GEM Paint graphics file:
BIT2WP fname1.BIT fname2.IMG
---
* To get a CompuServe GIF file:
BIT2WP fname1 /fg
or
BIT2WP fname1.BIT fname2.GIF
---
* To get a ZSoft PC Paintbrush PCX file
BIT2WP fname1 /fp
or
BIT2WP fname1.BIT fname2.PCX
==============
COMPLEAT USAGE
==============
If you invoke BIT2WP from DOS without any other parameters, it will display
the following help message. This illustrates some of the other options you
can select with command line switches.
-----
BIT/RLE-to-WP Image File Translator: V1.0 ... Copyright 1989 by W.J.Hinkle
Usage: BIT2WP fname1 [fname2] [options] ...
where: fname1.BIT ... Lotus Manuscript BIT input file
or fname1.RLE ... Lotus Manuscript RLE input file
fname2.WPG ... Word Perfect 5 WPG output file (default)
or fname2.TIF ... Aldus/Microsoft TIFF format output file
or fname1.BIT ... Lotus Manuscript BIT output file
or fname1.RLE ... Lotus Manuscript RLE output file
or fname2.IMG ... GEM IMG format output file
or fname2.GIF ... CompuServe GIF format output file
or fname2.PCX ... PC Paintbrush PCX format output file
Command Line Options:
/xN ... option: x density = N pixels-per-inch
/yN ... option: y density = N lines-per-inch
/v ... option: reverse video
/fw ... option: force WPG (Word Perfect) output file
/ft ... option: force TIFF output file
/fb ... option: force BIT (Lotus Manuscript) output file
/fr ... option: force RLE (Lotus Manuscript) output file
/fi ... option: force IMG (GEM) output file
/fg ... option: force GIF (CompuServe) output file
/fp ... option: force PCX (PC Paintbrush) output file
BIT2WP is a translator from Lotus Manuscript BIT/RLE image files
to various other word processor image file formats:
To Word Perfect 5 WPG files (fname2.WPG, or use /fw option),
or Microsoft/Aldus TIFF files (fname2.TIF, or use /ft option),
or Lotus Manuscript BIT/RLE files (fname2.BIT/RLE, or use /fb, /fr options),
or GEM IMG files (fname2.IMG, or use /fi option),
or CompuServe GIF files (fname2.GIF, or use /fg option),
or PC Paintbrush PCX files (fname2.PCX, or use /fp option).
Shareware by: William J. Hinkle CIS [71121,3211]
This utility may be distributed with other graphics converters by:,
William J. Hinkle
420 E.Boston Mills Road
Hudson, OH 44236
-----
=============
REVERSE VIDEO
=============
Normally BIT2WP keeps black and white the same between the BIT/RLE file and the
output file. If you want a reverse video effect, use the /v option switch.
==================
SIZING AND DENSITY
==================
Normally BIT2WP make a output file with the same image density as the
original scan. This lets your program compute the "natural" size of the
graphics image. You can specify a different density by specifying it with
either the /x or /y option switches (e.g. /x200 is 200 pixels and lines per
inch). You can also alter the aspect ratio (to "stretch" the image one way or
the other) by specifying both the /x and the /y option switches, with
different density values.
Of course, you can usually scale the image in your other application program.
======
HELP?!
======
Should you have any difficulties using this program, please
contact me via Compuserve EasyPlex (or on the CompuServe PICS forum):
William J. Hinkle [71121,3211]
======
THANKS
======
Thanks to:
Tom Pfau, for his public domain LZW compression/decompression code
==========
LEGALITIES
==========
Manuscript is a trademark of the Lotus Development Corporation.
Word Perfect is a trademark of the Word Perfect Corporation.
GEM is a trademark of the Digital Research Corporation.
GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc.,
an H & R Block Company.
PC Paintbrush is a trademark of ZSoft Corporation.
*************************************************************************
* Revision History: *
* ----------------- *
* Version number Date Explanation *
* -------------- ------ -------------------------- *
* 1.0 03 Dec 89 first public release *
*************************************************************************